home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 9 / Night Owl CD-ROM (NOPV9) (Night Owl Publisher) (1993).ISO / 001a / lnxinfo.zip / FAQFEB93.P4 < prev    next >
Internet Message Format  |  1993-03-03  |  45KB
  1. Path: labri.greco-prog.fr!corsini
  2. Newsgroups: news.answers,comp.answers,comp.os.linux,comp.os.linux.announce
  3. Distribution: world
  4. Followup-To: poster
  5. From: corsini@labri.greco-prog.fr
  6. Reply-To: linux@numero6.greco-prog.fr
  7. Organization: Greco Prog. CNRS & LaBRI, Bordeaux France
  8. Subject: Linux Frequently Asked Questions 4/4 [monthly posted]
  9. Approved: news-answers-request@MIT.Edu
  10. Summary: Linux, a small and free unix-like for 386-AT computers.
  11.  
  12. Archive-name: linux-faq/part4
  13. Last-Modified: 93/02/11
  14. Version: 1.16
  15.  
  16. *********************************************************
  17. *                            *
  18. *   Answers to Frequently asked questions about Linux   *
  19. *                            *
  20. *********************************************************
  21.  
  22. This post contains Part 4 of the Linux FAQ (4 parts).
  23. It must be read *after* the 3 first parts. 
  24.  
  25. ===================================8<====>8============================
  26. CONTENTS (of this part)
  27.  
  28.     XI.    NETWORKING and LINUX        (part4)
  29.     XII.    X11, THE MAXIMUM and MORE    (part4)
  30.     XIII.    EMACS for LINUX            (part4)
  31.  
  32. ===================================8<====>8============================
  33.  
  34.  
  35. XI.    NETWORKING and LINUX
  36. ============================
  37. *** This section should be maintained by Philip Copeland
  38. *** (p_copela@csd.uwe.ac.uk). This first version was built by myself
  39. *** (MM. Corsini) from the original material posted by Phil in c.o.l.
  40. *** I hope the information provided below are readable and useful.
  41. *** Last Update: 16 Jan 92 01:12:45 GMT
  42.  
  43.      **** In the ANSWER part the I/MY stands for P. Copeland ****
  44.  
  45. QUESTION: Where can I find useful information about networking for
  46. Linux ?
  47.  
  48. ANSWER: Join the NET channel of the mailing list. Also, you need to
  49. read the NET-FAQ by Phil Copeland, it's on sunsite and tsx-11 and 
  50. posted to c.o.l and the NET channel every couple of weeks.
  51.  
  52. Basically, all of the information on networking and TCP/IP for Linux
  53. is in the NET-FAQ, all that's given here is the Quick Start guide.
  54.  
  55. QUESTION: What do I need to get started ?
  56.  
  57. ANSWER: Here is the Linux TCP/IP Quick Start guide, version 1.2 by
  58. Matt Welsh. 
  59.  
  60. This is an excerpt from the Linux NET-FAQ by Phil which describes in a
  61. nutshell what you need to get and do to setup TCP/IP on a Linux
  62. machine. It's really quite easy.
  63.  
  64. I suggest that you get the NET-FAQ instead of just this document. This
  65. is an overview of the process. All of the details of inetd, named,
  66. etc. setup are in the NET-FAQ. This mostly talks about getting and
  67. installing the softs, just getting it to work. 
  68.  
  69. The NET-FAQ is posted occasionally to comp.os.linux.announce and can
  70. be FTP'd from sunsite.unc.edu or tsx-11.mit.edu. Let me know if you
  71. need help finding it (or I can mail you a copy).
  72.  
  73.  
  74. ** What you need to get started
  75.  
  76.    To configure TCP/IP under Linux you need:
  77.  
  78.    1)    A linux machine with linux kernel 0.98.5 although I'd
  79.     recommend going all the way to 0.99 as many tcp/ip errors
  80.     have been stomped out (although not all). Users of the
  81.     virgin 0.98.6 release will have to apply patches 1-12
  82.     available on sunsite.unc.edu:/pub/Linux/system/Network
  83.  
  84.    2)      Version 4.2 of the jump table library image (/lib/libc.so.4.2).
  85.     This is needed for the various network binaries and so on.
  86.     The most recent version is on sunsite.unc.edu:/pub/Linux/GCC.
  87.  
  88.    3)     If you're going to use TCP/IP over the network (i.e. not just
  89.     loopback mode), then you need one of the following Ethernet
  90.     cards:
  91.  
  92.     wd8013
  93.     wd8003
  94.     SMC Elite 16
  95.     ne2000
  96.     ne1000
  97.     3com503 EtherlinkII
  98.     Cabletron
  99.     various HP 8390-based boards
  100.  
  101.     The wd8003, wd8013, and SMC Elite 16 are all included in the
  102.     standard Linux kernel. The ne2000, ne1000, 3c503, Cabletron,
  103.     and other 8390 card drivers are available for beta testing.
  104.     This will be covered later.
  105.  
  106.    4)    If you are only going to use 'loopback' mode, you won't need
  107.     a card! A special loopback device is used to comunicate
  108.     with yourself. 
  109.  
  110.     *** NOTE when talking of ethernet devices, it should
  111.     be noted that /dev/eth0 does NOT exist, the kernel
  112.     knows about it and thats all you need to know, /dev/eth0
  113.     and /dev/loopback are fictionous (FS speaking)
  114.  
  115.    5)     The tcpip-0.8 networking package. This is the old, original
  116.     release of the TCP/IP software. The only things you need
  117.     from this package are the 'config' program and the network
  118.     installation scripts (such as rc.net, install.net, and so on).
  119.  
  120.     ALL of the binaries, kernel code, diffs, and so on in the
  121.     tcpip-0.8 package is obsolete. All you need from it is the
  122.     install.net, rc.net, and other configuration programs (this
  123.     is covered later).
  124.  
  125.     You also need the tcpip-0.8-fixes package.
  126.     It's available from all of the major Linux FTP sites, in the
  127.     file tcpip-0.8.tar.Z. The fixes are in tcpip-0.8-fixes.tar.Z.
  128.     They should both be in the same place.
  129.  
  130.    6)     The net-bin-0.2 package. It's on sunsite and tsx-11 in the
  131.     file net-bin-0.2.tar.Z. 
  132.  
  133.     This file contains all of the TCP/IP clients and daemons that
  134.     you'll need, including: telnet, telnetd, ftp, ftpd, inetd,
  135.     named, rcp, rlogin, rsh, talk, ping, nslookup, and more.
  136.  
  137.         
  138.    7)     The net-lib-1.1 package, on sunsite and tsx-11 as 
  139.     net-lib-1.1.tar.Z. It contains libnet.so.1.1, which is the
  140.     library used by the net-bin binaries. Although the network
  141.     libraries have been put back into libc.so.4.2, they were
  142.     still compiled to use libnet.so.1.1. (You can get the
  143.     net-src-0.2 package and recompile them yourself if you want).
  144.  
  145.  
  146.    8)     If you want NFS support, Linux 0.99 now contains NFS as a 
  147.     standard filesystem. But you'll need the NFS client program
  148.     from nic.funet.fi:/pub/OS/Linux/ALPHA/NFS and the new
  149.     version of 'mount' which supports the '-t nfs' option (should
  150.     be in the nfs client package).
  151.  
  152.    9)    Know the IRQ's of your internal cards. This is to avoid
  153.     conflicts and allow the 'drivers' to communicate with your
  154.     hardware
  155.  
  156.   10)    Also, If you do have ethernet cable, both coax (thin and thick)
  157.     as well as twisted pair will work, the cable is only there to
  158.     carry signals, your ethernet board works out how and the linux
  159.     'drivers' simply stuff data onto the card.
  160.  
  161.   11)    A lot of coffee and one of those stress relieving 
  162.     gadgets you can get in the local market. [Ed. note: I drank
  163.     about 3 Dr. Peppers and I was okay. -mdw]
  164.  
  165.  
  166. ** Setting it all up.
  167.  
  168. This is a rundown of what you need to do to setup TCP/IP. Read it
  169. through and then keep it all in mind as you're cleaning up all of
  170. the details below. It's not difficult if you do everything correctly.
  171.  
  172. It's not as quick as I wanted it to be. Basically I get all of the
  173. installation stuff straight and then let Peter explain the details
  174. of setting up named, etc. in the NET-FAQ. 
  175.  
  176. You can get the Linux NET-FAQ from sunsite.unc.edu and tsx-11.mit.edu,
  177. or I can mail you the most recent version if you don't have it. It
  178. fills in all of the gaps left here.
  179.  
  180. - First things first: Get all of the files, etc. listed above in
  181.   section 2.0. When unpacking the tcpip-0.8, tcpip-0.8-fixes, and 
  182.   net-bin packages, it's helpful to unpack them in seperate directories,
  183.   because we'll be moving the files around to the right places. For 
  184.   example, unpack tcpip-0.8.tar.Z in /usr/src/tcpip-0.8 and 
  185.   net-bin-0.2.tar.Z in /usr/src/net-bin (or something like that).
  186.  
  187.   BE WARNED: Some versions of SLS (including the current one, I think)
  188.   have all of the TCP/IP files in the wrong place. You need to check
  189.   and make sure that all of the files listed below are in the places
  190.   that are listed here (i.e. daemons go in /usr/etc/inet, and binaries
  191.   go in /usr/bin). If things aren't in the right place, you'll have
  192.   problems (like fingerd won't work if it can't find 'finger', and so 
  193.   on).
  194.  
  195. - Most of the files in tcpip-0.8 you don't need. After you've unpacked
  196.   it somewhere, take inet.tar and unpack it in /usr/etc/inet (which you
  197.   may need to create). You can delete the following files in 
  198.   /usr/etc/inet:
  199.       config
  200.       inetd
  201.       named-xfer
  202.       telnetd
  203.       named
  204.        (Don't worry; later we replace them with newer versions).
  205.  
  206. - The rest of the files from tcpip-0.8.tar.Z you can delete.
  207.  
  208. - Unpack tcpip-0.8-fixes.tar.Z in /usr/etc/inet. You can delete
  209.   the file 'config' from it.
  210.  
  211. - Take the config.c (from tcpip-0.8-fixes) and compile it in 
  212.   /usr/etc/inet with the command
  213.     gcc -o config config.c
  214.  
  215. - Unpack net-lib-1.1.tar.Z in /lib. It should contain the files
  216.     libnet.so.1 (symlink to libnet.so.1.1)
  217.     libnet.so.1.1
  218.  
  219. - Having unpacked net-bin-0.2.tar.Z in /usr/src somwhere, you
  220.   can install these binaries. The following files are copied to
  221.   /usr/bin:
  222.     ftp
  223.     telnet
  224.     ping (must be setuid root; i.e. do 'chmod 4755 /usr/bin/ping')
  225.     nslookup
  226.     nsquery
  227.     netest
  228.     rsh (must be setuid root)
  229.     rcp (must be setuid root)
  230.     rlogin (must be setuid root)
  231.     finger
  232.     talk 
  233.     tftp
  234.   The following files are copied to /usr/etc/inet:
  235.     ftpd
  236.     telnetd
  237.     inetd
  238.     named
  239.     named-xfer
  240.     rshd
  241.     rlogind
  242.     fingerd
  243.     ntalkd
  244.     tftpd
  245.   The man pages are copied to /usr/man... for example, all *.1 are
  246.   copied to /usr/man/man1 and *.8 are copied to /usr/man/man8.
  247.     
  248. - Now you've got all the software installed, you need to recompile
  249.   your kernel with TCP/IP enabled. This is easy unless you have an
  250.   old kernel (pre-0.99) or need to install the ne2000/3c503/ne1000
  251.   drivers. Here's how.
  252.  
  253.   IF you're installing the 8390/n2000/3c503/ne1000 drivers (from
  254.   super.org, directory /pub/linux/ethercards), follow the directions
  255.   below for installing the driver. If you're NOT installing the 
  256.   8390 driver, just skip down to compiling the kernel.
  257.  
  258.   Get the files that you need. See the README's there for full details.
  259.   Basically yo need:
  260.     8390.c
  261.     8390.h 
  262.     Space.c
  263.   one or more of ne.c, wd.c, 3c503.c, and so on, depending on
  264.   the card you have.
  265.  
  266.   Just follow the directions found in the file INSTALL on super.org.
  267.   It's easy. Just:
  268.       - Put the files above in /usr/src/linux/net/tcp
  269.       - Add 8390.o (and ne.o, 3c503.o, etc. depending on which card
  270.     you have) to OBJS in /usr/src/linux/net/tcp/Makefile,
  271.       - Edit Space.c (if needed),
  272.       - Add the proper defines for EI8390, EI8390_IRQ, etc. to
  273.     /usr/include/linux/config.h (this is covered in the 8390 driver
  274.     README files),
  275.       - Edit /usr/include/linux/rc.net (which you'll set up later) to
  276.     configure the device  'eth_if' instead of 'eth0'. Basically
  277.     change all occurances of 'eth0' in the file (there's only 1
  278.     or 2 of them) to 'eth_if'.
  279.  
  280.         If you have problems with the 8390 driver, contact becker@super.org.
  281.  
  282.       - If you're NOT installing the 8390 driver (i.e. just using the wd8003
  283.     driver with the standard kernel), then you need to edit 
  284.     /usr/src/linux/net/tcp/Space.c to reflect your card's IRQ, base
  285.     address, and so on. If you're only using loopback you can skip
  286.     this step, too.
  287.  
  288.     Anyway for those who are frexible, the standard kernel parameters
  289.         for this are :
  290.         
  291.          IRQ: 5        (card interrupt)
  292.          mem: D0000        (where in memory to buffer data)
  293.          i/o addr: 280    (low level address of card)
  294.          mem start: D0000    (nearly all boards have a jumper to
  295.                  set this)
  296.          mem end: D2000    (for wd8013, make this D4000)
  297.  
  298.     NOTE: If you have problems with the memory start addr for the 
  299.     WD80[0/1]3, please get in touch with bir7@leland.stanford.edu.
  300.  
  301.       - Now you're all set to compile the kernel. I really suggest that 
  302.     you use version 0.99.pl4 or newer (probably 1.0 by the time this
  303.     is out). If you don't have at least 0.99 you can't run 
  304.     'make config' to autoconfigure the kernel and you'll have to
  305.     do some stuff by hand.
  306.  
  307.     In any case, it's easy. If you have 0.99 or newer, just cd to
  308.     /usr/src/linux and do a 'make config'. Make sure you answer 'yes'
  309.     to the question on configuring TCP/IP. The rest of the options are
  310.     up to you. Also make sure you edit /usr/src/linux/Makefile to fix
  311.     your root device, keyboard, and so on.
  312.       
  313.     Then do a 'make dep' to fix your dependencies--- THIS
  314.     STEP IS VERY IMPORTANT. Then (if you've already compiled this 
  315.     version of the kernel) do a 'make clean'. FINALLY you're ready to
  316.     just do 'make' to compile the kernel.
  317.  
  318.      When you're done you'll have the new kernel in /usr/src/linux/Image.
  319.     Copy it to a floppy or install it in /etc for use with LILO, or 
  320.     whatever. Reboot with your new kernel.
  321.  
  322.       - Once you're rebooted you can configure the stuff in /usr/etc/inet.
  323.     Run the script 'install.net' there, and answer the questions to
  324.     set your IP address, net address, router, domain name, and 
  325.     nameserver. This is covered in the NET-FAQ.
  326.  
  327.       - I had to edit resolv.conf there to make sure that the hostname and
  328.     domain names were right. No big deal.
  329.  
  330.       - Set up your named configuration files. Named is the service that
  331.     allows your machine to act as a nameserver. If you have a real
  332.     nameserver already, you probably don't want to run named (wastes
  333.     memory). If you're on loopback, you don't need it either (just put
  334.     all of your hostnames and ip addresses in /usr/etc/inet/hosts). 
  335.     Named is nice if you have a LAN setup and want your Linux box to be 
  336.     the name server. This is covered in detail in the NET-FAQ as 
  337.     well.
  338.  
  339.       - Set up inetd.conf to include lines for all of the tcp/ip daemons
  340.     (such as telnetd, fingerd, etc.) that you have in /usr/etc/inet.
  341.     This is covered in the NET-FAQ.
  342.  
  343.       - Make sure that /usr/etc/rc.net is run from your /etc/rc.local.
  344.  
  345.       - Edit rc.net to make sure it's getting your IP address right. As
  346.     it stands now it tries to grep for it in /usr/etc/inet/hosts,
  347.     and this doesn't always work. I just hardcode my IP address in
  348.     rc.net since my IP address isn't going to change much. :)
  349.  
  350.     If you are only using loopback, make sure you comment the lines
  351.     in rc.net that config 'eth0' (since you don't have an Ethernet
  352.     card). 
  353.  
  354.     If you're using the 8390 driver (see above) make sure you've
  355.     changed 'eth0' to 'eth_if' in rc.net.
  356.  
  357.       - If you have a real nameserver, be aware that the hostnames/IP addrs
  358.     in /usr/etc/inet/hosts will be ignored unless you create the file
  359.     /usr/etc/inet/host.conf. It should contain only these 2 lines:
  360.         order hosts,bind
  361.         multi
  362.     This file tells the BIND libraries how to lookup hostnames. This
  363.     is covered more later. If it still doesn't work you don't have
  364.     either net-lib-1.1 or the newest jumptables (v4.2) installed.
  365.  
  366.       - If you want to use NFS (network file system), you're on your 
  367.     own. It should suffice to say that you need the nfs-client 
  368.     stuff from tsx-11 and nfs enabled in your kernel. Should be
  369.     easy, I haven't played with it yet.
  370.  
  371.       - If you didn't already, read all of the README files that come
  372.     with net-bin-0.2 and all that. They contain more up-to-date
  373.     info. NOTE that the info in tcpip-0.8's README file is mostly
  374.     out-of-date, follow the directions above and you'll be okay.
  375.  
  376.       - At this point you should be able to reboot your system, rc.net
  377.     will run, and you'll see something like
  378.         loomer -> 128.253.153.53
  379.         Starting /usr/etc/inet/inetd
  380.     which is output from rc.net. If you don't see this (or if
  381.     there are errors) then there's a problem; the best way to fix
  382.     this is to edit rc.net and the other files in /usr/etc/inet
  383.     and make sure you have your IP addresses and everything set right.
  384.  
  385. As I said, please get the NET-FAQ from sunsite or tsx-11 if you don't
  386. have it already. This Quick Start guide is part of that document. 
  387.  
  388.  
  389. XII. X11 THE MAXIMUM and MORE
  390. =============================
  391. *** This section is maintained by Krishna Balasubramanian
  392. *** <balasub@cis.ohio-state.edu>. Mail him if you have corrections,
  393. *** additions, etc.
  394. *** Last update: Tue, 16 Jan 93 19:06:57 -0500
  395.  
  396. XII.A. X386 GENERAL INFORMATION
  397. XII.B. HARDWARE REQUIREMENTS: Supported Video cards.
  398. XII.C. LINUX DISTRIBUTION: Files required, Current version.
  399. XII.D. LEARNING/USING X: Pointers to X documentation.
  400. XII.E. DEBUGGING STARTUP PROBLEMS: Checklist, Screen restoration, Hanging.
  401. XII.F. XCONFIG: Video mode settings and common errors in Xconfig.
  402. XII.G. X-APPLICATIONS: Compiling X programs.
  403. XII.H. BUGS
  404. XII.J. MISC: the things that I don't know where to put :)
  405.  
  406. The X11 directories are (depending on your version of X)
  407. XLIB = /usr/X386/lib/X11/ or /usr/lib/X11/ 
  408. XBIN = /usr/X386/bin/ or /usr/bin/X11/
  409.  
  410.  
  411.  
  412. XII.A. X386 GENERAL INFORMATION
  413. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  414.  
  415. QUESTION: What is the X11 release supported by Linux?
  416.  
  417. ANSWER: It's the X11R5 (xfree86-1.1). 
  418.  
  419.  
  420. QUESTION: What is X386/xfree86?
  421.  
  422. ANSWER: X386 is the port of the X11 server to System V/386 that was
  423. done by Thomas Roell (roell@informatik.tu-muenchen.de).  It supports a
  424. wide variety of VGA boards.  X386 1.2 is included in MIT's X11R5
  425. distribution.
  426.  
  427. The Linux X386 port was based on the stock distribution from X11R5,
  428. from MIT and was done by Orest Zborowski (obz@sisd.kodak.com).
  429.  
  430. It has since moved to becoming part of the standard xfree86 distribution.
  431.  
  432.  
  433. QUESTION: Where can I get X386 1.2 (X11R5)?
  434.  
  435. ANSWER: The X386 1.2 and xfree86 sources are available at any site that
  436. distributes the X11R5 source (too numerous to list here, but includes
  437. export.lcs.mit.edu)
  438.  
  439.  
  440. QUESTION: Any tips on compiling X11R5?
  441.  
  442. ANSWER:
  443. -  Dont do it.
  444. -  XFree86 is distributed with a link kit so you can optionally
  445.     include what you like in the server.
  446. -  You will need lots of disk space (around 150Meg for the MIT core). 
  447. -  Look at mit/server/ddx/x386/README and follow any instructions for
  448.     your particular platform. 
  449. -  Contact the X11 channel at linux-activists
  450.  
  451.  
  452.  
  453. XII.B  HARDWARE REQUIREMENTS:
  454. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  455. Approx: at least 4 megs of ram + swap ...slooooww. 10 Meg disk for X.
  456. Another 6-10 meg of disk for GCC if you want to compile X11 programs.
  457.  
  458. QUESTION: What VGA boards are supported?
  459.  
  460. ANSWER: 
  461.     et3000, et4000, gvga, pvga1a, wd890c00, tvga8900, ati ver. 5 or 6,
  462.         8514/A, generic vga: 800x600 mono (Xmono), 640x480x16 (Xega).
  463.  
  464.     Diamond cards are not supported and will not be supported.
  465. Contact Diamond if you have further questions or (better) buy another card. 
  466.  
  467. Standard x11v1.1 or xfree86 server:
  468.     ET3000         (for ex. GENOA 5300/5400)
  469.         ET4000         (Tricom, STB PWR Graph, Sigma Legend, etc.)
  470.         GVGA         (Genoa 6400)
  471.         PVGA1A         (Paradise VGA Professional) ... see BUGS.
  472.         WD90C00     (Paradise VGA 1024)
  473.  
  474. supported by xfree86:
  475.     TVGA8900     TRIDENT 8900 support is in xfree86    
  476.  
  477.     ATI        ATI VGA WONDER XL and most ATI VGA WONDER PLUS 
  478.             cards (chip version 5 or 6). 
  479.             Courtesy Rik Faith (faith@cs.unc.edu)
  480. ATI Notes: An example Xconfig file is available from ftp.cs.unc.edu:
  481. /pub/faith/linux/x386. Please note that:
  482. 1) clock.exe does *NOT* work with ATI cards.  
  483. 2) The ATI Wonder driver in xFree86 is known only to work with 
  484.    chip version 5 and 6 cards.  This is most ATI VGA Wonder PLUS cards 
  485.    and all ATI VGA Wonder XL cards (although sporadic problems have been
  486.    reported even with these very recent cards). The driver will tell 
  487.    you which ATI chip version you have, as will the ati.test program in
  488.    XLIB/etc/ 
  489.  
  490.  
  491. MONO    Any vga card should be able to use X386mono server. (At least
  492.     640x480 with 800x600 virtual). Use vga2 section of Xconfig.
  493.  
  494. Also available as ALPHA test versions (join the X11 channel):
  495. (The standard x386/xfree86 server will not handle the following cards)
  496.  
  497. 8514    ATI graphics ULTRA, ATI graphics Vantage 
  498.     (should work with any VESA standard 8514/A register compatible card?)  
  499.     tsx-11 pub/linux/packages/X11/X8514/  (X8514new.T.Z x.8514.src.T.Z)
  500.     courtesy Kevin Martin (martin@cs.unc.edu).
  501.  
  502. Xega    Generic 640x480x16 compatible server (originally for laptops).
  503.     This requires a microsoft mouse at /dev/mouse for now
  504.     and it does not use Xconfig so use environment variables
  505.     to define the font path etc. in .xinitrc:
  506.     export FONT_PATH=/usr/lib/X11/fonts/misc:/usr/lib/X11/fonts75dpi
  507.     Works better with courier fonts so add to .Xresources:  
  508.     *Font: -*-courier-medium-r-*--10* ..or whatever..
  509.     A link kit is available at tsx-11 (you need gcc2.2.2).
  510.     in pub/linux/ALPHA/Xega/X386.ega.T.Z
  511.     courtesy Marc Hoffman (marc.hoffman@analog.com).
  512.  
  513. The Xega server is compiled with the gcc-2.2.2 libs and should be 
  514. upgraded soon. It should however work with programs/fonts in new X11
  515. releases as long as you ensure you have the shared images needed by
  516. the server in /lib.
  517.  
  518.  
  519. XS3    S3 chipset server (Jon Tombs jon@robots.ox.ac.uk)
  520. I've started a FAQ on ftp.robots.ox.ac.uk (pub/linux/S3), but the Xserver 
  521. is still very alpha. Unless you know something about X386 and are prepared 
  522. to work at it, stick with the mono XFree86 server until you see different 
  523. advice. I'd hope to get the server integrated with XFree86 in the next 
  524. couple of weeks. This will make most the current problems go away.
  525.  
  526.  
  527. WARNING: Do not try to bring up an Xserver that does not support your 
  528. hardware. There have been cases where damage has resulted from pushing
  529. the monitor beyond its specs.
  530.  
  531.  
  532. QUESTION: What Mouses are supported?
  533.  
  534. ANSWER: Serial : Logitech, Microsoft, MouseSystems .... compatibles ...
  535.     Busmouses : Logitech, microsoft, ATI_XL, PS/2 (aux).
  536.  
  537.  
  538. QUESTION: Has anyone gotten the "Mini-DIN" mouse on an HP Vectra 486/33T 
  539. to work? The slight info I've been able to find says it's PS/2 compatible.
  540.  
  541. ANSWER: First you need to create an entry in /dev for it:
  542.  
  543. mknod /dev/psaux c 10 1
  544.  
  545. There is no direct PS/2 mouse support in XFree86 yet, so to use the
  546. mouse with X you'll have to use the mconv mouse protocol conversion
  547. utility, which can be found on nic.funet.fi, in
  548. /pub/OS/Linux/utils/tools/mconv.c. This program converts the packets
  549. sent by the PS/2 mouse into the corresponding ones from a Microsoft
  550. mouse, so you can fool X telling it you have a Microsoft serial
  551. mouse instead. Instructions for use are included in the source file.
  552. (Johan Myreen jem@cs.hut.fi)
  553.  
  554.  
  555.  
  556. XII.C. LINUX DISTRIBUTION
  557. ~~~~~~~~~~~~~~~~~~~~~~~~~
  558.  
  559. QUESTION: What is the current version?
  560.  
  561. ANSWER:    The newest public Linux release is x11v2.1. It is the linux 
  562. release of xfree86-1.1. It was compiled with gcc-2.2.2d and is available 
  563. for example at tsx-11 in pub/linux/packages/X11/xfree86-1.1/
  564. The SLS distribution stays at 2.0.
  565.  
  566. QUESTION: What Files do I need to download?
  567.  
  568. ANSWER: For x11v2.1: There is a README file in the distribution directory.
  569. Bring this down first and read it. Then get xbin, xman and xfonts.
  570. You need xprog and xlibman only if you plan to compile X applications.
  571. You dont need xkit if you want to relink the server.
  572.  
  573. **** You need The shared images libc.so.4 (4.1 or later) and libm.so.4 (4.0) 
  574. in /lib/. All the X11 binaries use these. To compile programs you should
  575. get gcc-2.2.2d7 or later and the 4.x libraries.
  576.  
  577. For Other servers see also the notes in the previous section.
  578.  
  579.  
  580.  
  581. QUESTION: Where do the X11 files go? What are they?
  582.  
  583. ANSWER: x11v2.1 uses the directories /usr/X386/bin/ (XBIN) for programs
  584. and /usr/X386/lib/X11/ (XLIB) for support files.
  585.  
  586. The support files include default/example Xconfig, xinitrc, twmrc
  587. which you should copy to your HOME directory (as Xconfig, .xinitrc
  588. and .twmrc) and edit them to define your hardware and X11 setup.
  589. The directory XLIB/etc/ contains some documentation which
  590. should explain how to configure your video.
  591.  
  592.  
  593.  
  594.  
  595. XII.D.  LEARNING/USING X
  596. ~~~~~~~~~~~~~~~~~~~~~~~~
  597.  
  598. QUESTION: Where can I find the basic help for learning/using X ?
  599.  
  600. ANSWER: Try man X386; man Xserver; man xterm; man twm; man xinit
  601. on any unix machine.  The man pages on xterm and twm will reflect
  602. behaviour on Linux systems quite accurately. The others will give you
  603. some bearing though not every option will work.  These man pages are
  604. part of the xfree86 distribution.
  605.     
  606.  
  607. QUESTION: What docs are available besides man pages?
  608.  
  609. ANSWER: The FAQ in comp.windows.x11 is extensive and has a bibliography. 
  610. There is also the Xt-FAQ. Both are available from export.lcs.mit.edu in
  611. pub/contrib/.
  612.  
  613.  
  614. QUESTION: [suggested by Thomas Koenig]
  615.     How do I support national keyboards in X11 ?
  616.  
  617. ANSWER: Put a .Xmodmap file into the user's home directory specifying
  618. which keys to use for what; or else replace the
  619. /usr/lib/X11/xinit/.Xmodmap with the national keyboard keys
  620. customized. Do man xmodmap for more details. 
  621. enclosed an excerpt of mine (french keyboard):
  622. keycode   8 =
  623. keycode   9 = Escape
  624. keycode  10 = ampersand 1
  625. keycode  11 = eacute 2 asciitilde
  626. keycode  12 = quotedbl 3 numbersign
  627. keycode  13 = apostrophe 4 braceleft
  628. keycode  14 = parenleft 5 bracketleft
  629. keycode  15 = minus 6 bar
  630. keycode  16 = egrave 7 grave
  631. keycode  17 = underscore 8 backslash
  632. keycode  18 = ccedilla 9 asciicircum
  633. keycode  19 = agrave 0 at
  634. keycode  20 = parenright degree bracketright
  635. keycode  21 = equal plus braceright
  636. keycode  22 = BackSpace
  637. keycode  23 = Tab
  638. keycode  24 = A
  639. ........
  640.  
  641.  
  642. XII.E. DEBUGGING STARTUP PROBLEMS:
  643. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  644.  
  645. QUESTION: How do I start up X?
  646.  
  647. ANSWER: Type 'startx' at the shell prompt.
  648. Before doing this you should:
  649. 1) copy the file Xconfig.sample from the XLIB directory to your 
  650.     HOME directory (/usr/root/Xconfig?) or to XLIB/Xconfig.
  651. 2) Edit Xconfig and set the video data for you card and monitor. 
  652.    Use the clocks appropriate for your card and the modes appropriate 
  653.    for your monitor for those clock values. To determine what values are
  654.    appropriate read files in XLIB/etc and the Xconfig section below. 
  655. 3) Set the mouse device in Xconfig correctly....Use the busmouse entry
  656.    for Logitech only. For other busmouses use microsoft.
  657. 4) Ensure that there is a termcap entry for xterm in /etc/termcap
  658.    (One is available in the subdir /doc).
  659. 5) Ensure that the X11 binaries are in the path example:
  660.    add the line PATH=${PATH}:/usr/X386/bin to ~/.profile or
  661.    look at bash.ad in /doc.
  662. WARNING: NONE of the modes (in the Modes line in Xconfig) should use a 
  663. clock your monitor cannot handle.
  664. Now type startx.
  665.  
  666.  
  667. QUESTION: I cannot type in my xterm 
  668.  
  669. ANSWER: /dev/console must have major=4, minor=0
  670.     rm -f /dev/console; ln /dev/console /dev/tty0
  671.  
  672.  
  673. QUESTION: What are some of the common omissions and errors?
  674.  
  675. ANSWER: (Peter)
  676. 1) Add /usr/bin/X11 (or /usr/X386/bin) to your path.
  677.  
  678. 2) Add the xterm termcap entry to /etc/termcap.
  679.  
  680. 3) ln -s X386 X in the XBIN directory.
  681.    ln -s X386mono X (if you want to use the mono server).
  682.  
  683. 4) Run X as root first. This avoids some trivial problems.
  684.  
  685. 5) If you change the font path entry .... X386 is finicky about
  686.    the syntax. 
  687.  
  688. 6) Make sure your mouse entry in Xconfig points to a legitimate serial 
  689.    device  (or busmouse)... usually something like:  microsoft "/dev/ttys1"
  690.    serial devices have major # 4 minor 64,65 ... busmouses are major 10.
  691.    ls -l in /dev will show you the major and minor entries.
  692.  
  693. 7) Need read/write/exec access to /tmp directory 
  694.  
  695. 8) Use startx 2> x.err to log your error messages. If the server sticks 
  696.    and you have to reboot you'll probably loose this stuff... see notes
  697.    on `hanging' below.
  698.  
  699. 9) See Xconfig problems and the device list below.
  700.  
  701. 10) Have you read the X386 man page?
  702.  
  703.  
  704. QUESTION: Why is the server unable to find some of the fonts?
  705.  
  706. ANSWER: First check that the directories listed in the font path exist
  707. and have font files in them. Some of the servers are not set up to use 
  708. compressed fonts. In such cases you have to uncompress the fonts in the
  709. directory and run `mkfontdir .`. Read the man page on mkfontdir.
  710.  
  711.  
  712. QUESTION: My server "hangs" Why?
  713.  
  714. ANSWER: (Peter) Quite often it isn't a hang. If the server grabs the
  715. screen(and enters graphics mode) and then dies, it may return you to
  716. bash *without* restoring the screen. In other words, just because you
  717. see no output, don't assume it's running/hanging.  The way to test
  718. this is to see if you can use a bash command to spin your disk. eg.:
  719. sync; ls -l /bin.
  720.  
  721. Also - I *suspect* that (at least for me), you can kill the
  722. server if you include the servernum option in the Xconfig
  723.  
  724. You can kill the server when you want to by typing ctrl-alt-backspace. 
  725. Then a couple of ctrl-C 's in case your stuck in xinit.
  726.  
  727. The two line message
  728.          X386 version .....
  729.          (protocol Version ....
  730. is returned from the X386 programme itself, so if you get
  731. this (or if the screen blanks) X must be starting.
  732.  
  733.  
  734. QUESTION: When I try to use X11 I got "Cannot connect to
  735. server" or "process does not exist", any clue ?
  736.  
  737. ANSWER: The cause might be wrong fontpath variable setup in your
  738. Xconfig; uncomment and set the correct fontpath variable.
  739.  
  740.  
  741. QUESTION: Why cant I run more than 4 xterms?
  742.       How can I have more than 4 pty's ?
  743.  
  744. ANSWER: set the number in the header include/linux/tty.h and 
  745. recompile the kernel. Also make nodes :
  746.     mknod /dev/ptypxx 4  minor  (where minor = 128 + xx)
  747.     mknod /dev/ttypxx 4  minor  (minor = 192 + xx)
  748.     This is for before linux-0.97pl6.... for later versions
  749.     you only need to make the nodes.
  750.     
  751.  
  752. QUESTION: I have trouble with my logitech Pilot mouse and X under
  753. Linux, any clue ? 
  754.  
  755. ANSWER: (Thomas Roell?) There are TWO line of Logitech mice out there.
  756. One is the programmable and uses MouseSystems protocol at startup.
  757. X386 reprogramms them to use another protocol. If you specify
  758. 'Logitech' in the Xconfig, X386 assumes a mouse like C7 or S9 (notC7-M).
  759. The second line is the MicroSoft compatible. Currently all newer
  760. Logitech mice follows this practice, like the MouseMan. In that case
  761. you have to say 'MicroSoft' or 'MouseMan'. 
  762.  
  763. From: jliddle@rs6000.cmp.ilstu.edu (Jean Liddle)
  764. I just purchased a new logitech mouseman, and yes, the new X-Windows
  765. (XFree86 as opposed to X386) requires that you use the "microsoft" mousetype.
  766. However, if you turn Third Button Emulation off, the middle button WILL work.
  767.  
  768.  
  769. QUESTION: How does X11 start up?
  770.  
  771. ANSWER: The startup involves the server (XBIN/X), and some
  772. programs like startx and xinit.
  773.  
  774. Typing startx runs the script  XBIN/startx. Look through startx. 
  775. For explanation of the server arguments try man Xserver.
  776. startx does little other than gather arguments and then call xinit.
  777.  
  778. xinit **calls** X (X is linked to X386). xinit therefore continues to
  779. run, and quite often you will receive error messages from xinit rather
  780. than X itself. If you get the message "giving up", it means X has died
  781. (quite probably it died immediately) and xinit has been unable to start
  782. x applications. xinit processes the startup script xinitrc.
  783.  
  784.  
  785. QUESTION: How can I see what startx passes to xinit, and xinit to X?
  786.  
  787. ANSWER:  Add the line:  set -x      near the top of startx.
  788.  
  789. To see what xinit passes to X, try: (Peter)
  790.  
  791.     rm XBIN/X
  792.  - yes, if you have set it up correctly, X should only be a link 
  793.  so it's safe to remove it.
  794.  
  795.  then create a shell script XBIN/X containing:
  796.     #/bin/sh
  797.     echo $*
  798.  and run startx. You should see something like:
  799.     X :0
  800.  which is all xinit passes to X. If you don't see the :0, you may not
  801.  have your DISPLAY=":0" set correctly. THEN RESTORE X!! :
  802.     cd XBIN; rm X; ln -s X386 X
  803.  
  804.  
  805. QUESTION: What devices does X depend on:
  806.  
  807. ANSWER: check your device numbers with ls -l /dev. You should have:
  808.  
  809. 5 0 tty
  810. 4 0 tty0
  811. 4 0 console
  812. 4 1 tty1 (etc)
  813. 1 1 mem
  814.  
  815. 4 128 ptyp0         pseudo ttys used by xterm/emacs etc 
  816. 4 129 ptyp1 (etc)    to talk to unix programs.
  817. 4 192 ttyp0
  818. 4 193 ttyp1 (etc)
  819.  
  820. 4 64 ttys1         one of these is the mouse 
  821. 4 65 ttys2        or you have a busmouse.
  822. 10 x mouse         busmouse x = 0 => logitech     1 => ps/2 (aux)
  823.             2 => microsoft        3 => ATI_XL.
  824. /tmp/.X11-unix/X0       socket used by X apps to talk to the server.
  825.             this is created by X386.
  826.  
  827.  
  828.  
  829.  
  830. XII.F. Xconfig: Xconfig and Video mode settings.
  831. ~~~~~~~~~~~~~~~
  832. QUESTION: What do the mode names mean?
  833.  
  834. ANSWER: The mode names like "640x480" are used to match entries in 
  835. the modes line with the modeDB entry which actually defines the mode. 
  836. You can toggle between modes in the modes line  with ctrl-alt-numericplus. 
  837. If you're experimenting with 640x480 you can define 
  838.       modes "640x480a" "641x480b" "642x480c"
  839. with corresponding entries under ModeDB so you can toggle between 
  840. these three modes. Try man X386.
  841.  
  842. QUESTION: How do I compute the numbers for the video modes?
  843.  
  844. ANSWER: See if there is an entry that matches your chip/monitor in
  845. XLIB/etc/modeDB.txt. Use the clock entries for your chip
  846. and the mode entry for that clock appropriate for your monitor.
  847. If you cant find a mode entry for a particular clock 'needed_clock'
  848. but can find a mode entry (for your monitor) for a nearby clock value
  849. 'found_clock', scale all numbers in the modeDB entry by 
  850. (needed_clock/found_clock). man X386 and Read CONFIG and Xconfig.notes.
  851.  
  852.  
  853. QUESTION: How can I determine the clocks on the video chip?
  854.     Where can I find clock.exe or clock.pas ?
  855.  
  856. ANSWER: The XFREE Team discourages the use  of clocks.exe and wants it
  857. to be removed from all docs, since the new Server is better at
  858. guessing the clocks than clocks.exe.
  859.  
  860. You can get X to tell you what it finds by commenting the
  861. clocks entry in Xconfig. Use 'startx 2> x.err' to log the output.
  862. If X starts up this file gets the clocks only after you exit.
  863.  
  864. I strongly advise using the 'modegen' spreadsheets to generate the 
  865. appropriate settings. If I remember correctly you can find them in 
  866. 'pub/linux/packages/SLS/x4' called modegen.taz or something equally 
  867. as obvious ... Good luck. (Andy asb@cs.nott.ac.uk)
  868.  
  869. The clocks entry in Xconfig serves as an index. example: 
  870. clocks 1 2 
  871. ModeDB
  872. 1 640x480 .....
  873. 2 800x600 .....
  874. means the first clock on the chip will be used for the 640x480 mode
  875. and so on. Usually one uses the MHz value for the clock for convenience
  876. instead of 1 2  you probably have 25 28 ... etc.
  877.  
  878.  
  879. QUESTION: What are the settings used with a trident-8900C?
  880.  
  881. ANSWER: To get X/SLS/Linux working with a trident-8900C, do the following:
  882.  
  883. 1) From Frank Houston fh8n@uvacs.cs.Virginia.EDU 
  884. vga256
  885.   Virtual    1024 768
  886.   ViewPort      0 0
  887.   Modes            "1024x768" "800x600" "640x480"
  888. Use the VESA monitor timings from the modeDB in the example Xconfig.
  889. You do not need to specify the chipset or clocks.
  890.  
  891. 2) From: Henk Vandecasteele henkv@cs.kuleuven.ac.be 
  892. TRIDENT TVGA 8900C card with BIOS C2.11, A cheap color monitor AOC (CM-335) 
  893. with a maximum horizontal frequence of 39.5
  894. vga256
  895.   Virtual    1024 1024
  896.   ViewPort      0 0
  897.   Modes        "912x684" "800x600" "640x480" 
  898. # This mode drives my monitor to the limit (VESA timings for the rest).
  899.  "912x684"     45      912  944 1104 1136    684  684  690  712 
  900.  
  901.  
  902. QUESTION: What are common problems with Xconfig?
  903.  
  904. ANSWER: If X isn't firing at all, or even if it clears the screen and
  905. crashes (see below) you almost certainly have a fault in Xconfig.
  906.  
  907. 1. Note that the server X interprets Xconfig. (not xinit)
  908.  
  909. 2. If you have a fault in Xconfig it is possible to crash or hang the
  910. server without getting an error message.
  911.  
  912. 3. leave the two paths at the top of Xconfig commented out when testing.
  913.  
  914. 4. test with only one graphics mode included - one you are most sure of.
  915.  
  916. 5. If you make a mistake in the mouse section, you will (I understand)
  917. get an error message, so if you don't get some mouse error, try
  918. elsewhere first. (eg "No such file or directory" indicates you have a
  919. fault in the "/dev/ttyxx" line, or /dev/ttyxx doesn't exist.
  920.  
  921. 6. *NB* X looks in your home directory first to find an Xconfig. make
  922. certain it's using the one you've been working on!
  923.  
  924. 7. you need double quotes (") around your chipset and modes: eg
  925.     chipset "et4000"
  926.     Modes   "640x480" "640x480a" "800x600"
  927. and around the /dev/ttyxx eg.:
  928.     microsoft "/dev/ttys1"
  929.  
  930. 8. Check your VGA section and modeDB first.
  931.  
  932. 9. ensure ModeDB clock speeds match the VGA section. Comment out any
  933. unused lines in MODEDB.
  934.  
  935. eg  clocks  25 36 00 00 00 00 00 00 
  936.  
  937. then you *must* have (and only have) lines under modeDB corresponding
  938. to speeds 25 and 36. If you have one with (say) 62 uncommented out in
  939. the modeDB section in place of the 36 line, you will cause the server to
  940. die immediately with no error message.
  941.  
  942. 10. a syntax error (such as an unrecognised word) in Xconfig will cause
  943. a death with no warning.
  944.  
  945. 11. videoram must equal the amount of display ram on your chip.
  946.  
  947.  
  948. QUESTION: What do I use in my Xconfig file to use the bus mouse?
  949. Logitech doesn't work with my Logitech busmouse.
  950.  
  951. ANSWER: (Nathan I. Laredo)
  952. Here are the mouse lines from my Xconfig:
  953.  
  954. BusMouse   "/dev/mouse"
  955.  
  956. You may add a sample rate if you want, but chances are, unless the model
  957. number on your mouse matches mine: PC-93-9MD it probably will cause your
  958. machine to lock up, as I've gotten several reports saying that.
  959.  
  960. According to the X386 documentation, non-logitech mice do not support
  961. a sample rate.
  962.  
  963.  
  964.  
  965.  
  966.  
  967. XII.G X-APPLICATIONS: Compiling X Programs.
  968. ~~~~~~~~~~~~~~~~~~~~~
  969.  
  970. QUESTION: Does anyone know where I can find the libobz.a library ?
  971.  
  972. ANSWER: This library contained the socket stuff, when X386 V0.1 was
  973. released. Meanwhile it has found it's way into the kernel, so
  974. remove -lobz from the link step in the Makefile.
  975.  
  976.  
  977. QUESTION: I get _setjmp undefined when linking xv from .a files.
  978.  
  979. ANSWER: You are trying to link a program compiled with gcc-2.2.2
  980. and setjmp has changed sice then. Recompile xv from the source
  981. using the latest gcc.
  982.  
  983.  
  984. QUESTION: How do I compile an X application that has an Imakefile?
  985.  
  986. ANSWER:
  987.     Type xmkmf to generate the Makefile.
  988.     Type make.
  989.  
  990.  
  991. QUESTION: gcc complains the X libraries are not found or links static.
  992.  
  993. ANSWER: Check out the -nojump -static options of GCC ... read the GCC FAQ.
  994.     You can tell gcc what directories to search with -L. 
  995.  
  996.  
  997.  
  998.  
  999. XII.H BUGS:
  1000. ~~~~~~~~~~~
  1001. Restoration of the text screen fails on some hardware.
  1002.  
  1003. Cant compile Xaw programs without -static in versions x11v1.1 or older.
  1004. There is a glitch with the Xaw shared libs ... I haven't seen
  1005. this in a while anyway its fixed in newer releases.
  1006.  
  1007. Color problems with Xega .... fixed in latest version on tsx-11.
  1008.  
  1009. from chuck@coplex.com (Chuck Sites)
  1010. It is possible to run X386 on a Paradise VGA Plus. The X386.0 doc file
  1011. has a small misprint.  The Chipset is not pvga. It's pvga1.   Anyway,
  1012. under the line in /usr/X386/lib/X11/Xconfig VGA256, add, `chipset "pvga1"`.
  1013. You will need a 512k board.  There seems to be a problem with 800x600 mode
  1014. that causes pixels to be misplaced in the center 1/3 of the screen. 640x480
  1015. works fine.  Anybody out there might have a fix for that? You may want to use
  1016. X386mono with 800x600 instead.
  1017.  
  1018.  
  1019. Fix for missing numlock control in xfree86-1.1.
  1020. use xmodmap to change the mapping:
  1021.   clear mod1
  1022.   add mod1 = Alt_L
  1023.   keysym Alt_R = Mode_switch
  1024.   add mod5 = Mode_switch
  1025. David (Dawes)
  1026.  
  1027. XII.J. MISC
  1028. ~~~~~~~~~~~
  1029. QUESTION: When using Makefiles generated by xmkmf why do I get many error 
  1030.     messages?
  1031.  
  1032. ANSWER: Currently xmkmf under Linux doesn't like # comments in Imakefiles. 
  1033. Therefore you must change the #'s to XCOMM. But be careful. Don't change
  1034. any pre-compiler directives. (mal11@po.CWRU.Edu  Matthew A. Lewis)
  1035.  
  1036.  
  1037. QUESTION: Why do I get the  error message 'could not open default font'
  1038.     when I start X?
  1039.  
  1040. ANSWER: Some servers only work with compressed (uncompressed) fonts.
  1041. So compress (uncompress) the font files in misc and 75dpi directories and 
  1042. run `mkfontdir .`. Leave the files fonts.alias and fonts.dir uncompressed.
  1043.  
  1044.  
  1045. QUESTION: Why is it I cannot get Xfree86 to work with my trident card?
  1046.  
  1047. ANSWER: You should get xfree86-1.1 which has improved trident support.
  1048. SLS contains 1.0Ya (I believe). If you have SLS already and a slow 
  1049. connection get xbin2.1.TZa from the xfree86-1.1 distribution on tsx-11.
  1050.  
  1051.  
  1052. Sources for X11_FAQ: 
  1053. Steve Kotsopoulos, Peter Hawkins, John Morris, MM. Corsini, 
  1054. K. Balasubramanian. 
  1055. Direct comments, questions, complaints to krishna at:
  1056. balasub@cis.ohio-state.edu
  1057.  
  1058.  
  1059. XIII. EMACS for LINUX
  1060. =====================
  1061. *** This section is maintained by Rick Sladkey (jrs@world.std.com)
  1062. *** Last Update November 1992.
  1063.  
  1064. XIII.A. GENERAL INFORMATION 
  1065. XIII.B. GNU EMACS for LINUX
  1066.  
  1067. XIII.A. GENERAL INFORMATION
  1068. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1069.  
  1070. This is a short list of Frequently Asked Questions about GNU Emacs
  1071. under Linux.  It does not address general questions about Emacs which
  1072. are not Linux specific.  For general help about Emacs, 1) learn to use
  1073. and read the online documentation, 2) read the real Emacs FAQ found in
  1074. emacs/etc/FAQ, and 3) read the newsgroup gnu.emacs.help.
  1075.  
  1076.                                         Rick Sladkey <jrs@world.std.com>
  1077.  
  1078. XIII.B. GNU EMACS for LINUX
  1079. ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  1080. QUESTION: Does Linux Emacs use the shared libraries?
  1081.  
  1082. ANSWER: Yes.  It wasn't easy.  If you have any problems with them let
  1083. me know. Also contact me if you would like static binaries.
  1084.  
  1085. QUESTION: What version of the compiler was used?  Which shared libaries?
  1086.  
  1087. ANSWER: This describes version of GNU Emacs 18.59 for Linux 0.97 and above
  1088. compiled with GCC 2.2.2d7 using the libc.so.4.1 and libX11.so.2.1 shared
  1089. libraries.
  1090.  
  1091. QUESTION: Which files do I need?
  1092.  
  1093. ANSWER:
  1094. emacs-18.59a.tar.Z        this file, sample default.el and diffs
  1095.                 for this version, the eight-bit patch,
  1096.                 iso-latin-1.el and eight-bit.el
  1097. emacs-etc-18.59a.tar.Z        emacs support programs and misc info
  1098. emacs-bin-18.59a.tar.Z        shared emacs binary and its doc file
  1099. x11emacs-bin-18.59a.tar.Z    shared x11emacs binary and its doc file
  1100.  
  1101. QUESTION: How do I install them?
  1102.  
  1103. ANSWER: According to Linux convention, cd to /usr and untar the
  1104. packages. 
  1105.  
  1106. QUESTION: Does Linux Emacs support eight-bit input/output?
  1107.  
  1108. ANSWER: Yes.  It is new with this version.  It uses the so-called
  1109. "ctl-arrow" patch.  See the file README.8bit for more information.
  1110.  
  1111. QUESTION: How much disk space is required?
  1112.  
  1113. ANSWER: Anywhere from 1 to 15 Meg.  Emacs works reasonably well with no
  1114. support files at all.  With a judicious selection from lisp/*.elc and
  1115. etc/*, quite a lot can be done using only 2 Meg.  If you want all of
  1116. lisp/*.elc, info/*, and etc/* this will require 4 to 6 Meg.  If you
  1117. unpack the whole source you need 8 Meg.  If you collect info files
  1118. like rare coins and install a lot of big lisp packages then Emacs may
  1119. need its own partition. :-)
  1120.  
  1121. QUESTION: Why does Emacs crash under Linux 0.98 patchlevel 4 or higher?
  1122.  
  1123. ANSWER: It crashes becuase of the a new 256-bit wide fd_set structure. 
  1124. Sometimes progress requires sacrifice.
  1125.  
  1126. QUESTION: Why can't Emacs find its support files anymore?
  1127.  
  1128. ANSWER: This is because older versions of Emacs were compiled with
  1129. "/usr/local/emacs" based paths.  The current version is compiled with
  1130. "/usr/emacs" paths.  If you have a previous installation, just "mv
  1131. /usr/local/emacs /usr" and you're done.  If you can't bear to part
  1132. with the "/usr/local" pathnames because of inertia then do "ln -s
  1133. /usr/local/emacs /usr" and you can have them both.
  1134.  
  1135. QUESTION: How do I get Emacs to recognize my cursor keys?
  1136.  
  1137. ANSWER: Simple.  Don't use them. :-)  Seriously, there are as many
  1138. ways to do this are there are elisp hackers but the preferred way is
  1139. to follow the pattern set by the other terminal definition files in
  1140. emacs/lisp/term/*.el.  For just arrow keys you can just copy vt220.el
  1141. to console.el and that's it.  For function keys and the others see
  1142. the sample default.el included with this file.
  1143.  
  1144. QUESTION: What packages are particularly useful under Linux?
  1145.  
  1146. ANSWER: Because info format is the documentation standard of the GNU
  1147. project and just about everything except the kernel comes from FSF,
  1148. you will find that Dave Gillespie's enhanced info package is very
  1149. useful.  It allows multiple info directories, space bar paging, and
  1150. supports compressed info files. Please learn to use info.  Imagine
  1151. Unix life without man.
  1152.  
  1153. Others that I highly recommend are Sebastian Kremer's enhanced
  1154. dired directory editor, Dave Gillespie's calc calculator, Masanobu
  1155. UMEDA's gnus for usenet news, and Kyle Jone's vm for mail.
  1156.  
  1157. All can be found in the OSU Emacs archive.  See the real FAQ for more
  1158. details.
  1159.  
  1160. QUESTION: Does Linux Emacs use the shared libraries?
  1161.  
  1162. ANSWER: Yes.  It is very delicate.  Emacs uses its own malloc and the
  1163. library uses the standard one.  Everything works as long as the two
  1164. never meet. 
  1165.  
  1166. QUESTION: Does Linux Emacs support the X Window System?
  1167.  
  1168. ANSWER: Yes.  However, there are two binaries.  One without X support
  1169. (about 485k) and one with X support (about 515k).
  1170.  
  1171. QUESTION: Do I need both Emacs if I don't always use X?
  1172.  
  1173. ANSWER: No. The X11 version works equally well inside or outside of X.
  1174. If you get the message "Check your DISPLAY variable" it means that
  1175. you have defined DISPLAY in your ~/.profile (or whatever).  You can
  1176. fix this by starting Emacs with 'emacs -nw' or by removing the DISPLAY
  1177. variable from your ~/.profile and putting it in you ~/.xinitrc.
  1178.  
  1179. QUESTION: Why doesn't Emacs use the settings in my
  1180. .Xdefaults/.Xresources file? 
  1181.  
  1182. ANSWER: You are probably using the word "emacs" and your X version of
  1183. emacs is called x11emacs.  Either use the word "Emacs" in your resource
  1184. file or rename x11emacs to emacs.  See above question on why this
  1185. is reasonable.
  1186.  
  1187. QUESTION: I read about some menu that is supposed to pop up when I
  1188. press some mouse button.  Does this work with Linux Emacs?
  1189.  
  1190. ANSWER: Yes.  This requires XMenu support to be compiled in.  Former
  1191. versions did not support it because it did not work correctly.
  1192.  
  1193. QUESTION: Sometimes Emacs crashes with a SIGALRM message.  What's
  1194. wrong? 
  1195.  
  1196. ANSWER: You need to upgrade to a newer version of bash.  Some older
  1197. versions of bash were compiled with buggy libraries that caused bash
  1198. to send a SIGALRM to its parent in some circumstances.  Recent
  1199. versions do not exhibit this problem.
  1200.  
  1201. QUESTION: Why does Emacs always put me in the root directory?
  1202.  
  1203. ANSWER: You have an old version of Emacs compiled before GCC 2.11c and
  1204. you are using the Linux extended filesystem.  Get the new version.
  1205.  
  1206. QUESTION: Why doesn't Control-Z doesn't work right with Emacs?
  1207.  
  1208. QUESTION: Why doesn't job control work in shell mode?
  1209.  
  1210. ANSWER: You have a really old version of Linux Emacs.  Get the new one.
  1211.  
  1212.        ===================8<==========>8================
  1213.  
  1214.  
  1215.